home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / editor / mintr151.zip / README.1ST < prev    next >
Text File  |  1996-08-23  |  6KB  |  160 lines
  1. MiniTrue is a fast and versatile text search/view/replace utility run
  2. from the DOS command line. MiniTrue should work on all PC-compatibles
  3. with 200K of free memory. MiniTrue is freeware and can be included on
  4. shareware/freeware CDs. All other manners of distribution which involve
  5. payment require prior permission.
  6.  
  7. Email:    apipkin@nando.net
  8. Web site: http://www.webbuild.com/~apipkin
  9.  
  10. File List:
  11. MT.EXE        - program file
  12. MINITRUE.DOC  - main documentation
  13. README.1ST    - this file
  14. UNIX2DOS.BAT  - MiniTrue batch file - converts UNIX newlines to DOS
  15. DOS2UNIX.BAT  - MiniTrue batch file - converts DOS newlines to UNIX
  16. HTMLSTRP.BAT  - MiniTrue batch file - will strip tags from HTML files and
  17.                 store the stripped versions with the extension .TXT
  18. TEXTTOC.BAT   - MiniTrue batch file - converts a text file into a C
  19.                 string constant and stores the string constant with
  20.                 the extension .CPP. The first argument is the name
  21.                 of the text file, the second is the name of the string
  22.                 variable.
  23. HTMSHORT.MT   - MiniTrue string file - converts HTML "shorthand" to
  24.                 regular HTML. HTMSHORT.MT is used with the /i option.
  25.                 (See file for information)
  26.  
  27.  
  28. Backwards Incompatibilities with MiniTrue 1.0:
  29.     (Ignore if you are unaware of the existence of MiniTrue 1.0)
  30.  
  31.     The main difference between versions 1.0 and 1.5 is the order of the
  32. arguments on the command line. While the order in MiniTrue 1.0 was
  33. [files] [options]; [strings], in 1.5 the arguments go [options] [files]
  34. / [strings]. If only one file is to be searched, the slash between the
  35. files and strings can be omitted.
  36.  
  37. 1.0 options and their 1.5 equivalent
  38.     /f - Fifty column display              = /v set Video mode
  39.     /g - vary gap between strings in union = /u set Union parameters
  40.     /n - display non-ASCII strings         = /p change printing chars
  41.     /p - skip prompting                    = /n no prompting
  42.  
  43.     Log is written to a file instead of standard output
  44.  
  45.     Regular expressions of zero length are now allowed
  46.  
  47.     File names are no longer saved with the default configuration. Use
  48.     a batch file or a file used with the /@ option to perform operations
  49.     over a group of files.
  50.  
  51.     Must press 'n' instead of any key to move to the next match
  52.  
  53.     \i representing found string can only be used with regular expression
  54.  
  55.     Make sure the configuration file for MiniTrue 1.0 is not in your path
  56.     when using version 1.5, because the configuration files are not
  57.     compatible.
  58.  
  59. Changes for version 1.5.1 over 1.5.0
  60.     Bug fixed - can now make replacements in standard input if output is
  61.         sent to standard output
  62.     MINITRUE.CFG file version-sensitive - can only be used with version
  63.         of MiniTrue it was created with
  64.  
  65.  
  66. Improvements for version 1.5.0
  67.  
  68.     MiniTrue 1.5 does not limit text viewing to only one screen like 1.0
  69. did; the entire file can be scrolled through.
  70.  
  71.     Can decompress .ZIP files (and files from virtually every archiver)
  72. before scanning them.
  73.  
  74.     MiniTrue 1.5 features accelerated scrolling. The scrolling speed will
  75. increase as the up/down arrow keys are held down. This behavior can be
  76. escaped by using the f and v keys to move up or down a line. The /s option
  77. will turn accelerated scrolling off completely.
  78.  
  79.     More options for writing to standard output and can scan standard
  80. input
  81.  
  82.     Can generate a batch file automatically from the arguments on the
  83. command line
  84.  
  85.     Support for nonstandard video modes (such as 132 * 43)
  86.  
  87.     And many more
  88.  
  89.  
  90. Notes
  91.  
  92.     To see the help screens of MiniTrue, just type mt and press enter.
  93. To view the main documentation file in the textviewer mode of MiniTrue,
  94. type mt minitrue.doc and press enter.
  95.  
  96.     A filename ending in * without an extension will be expanded to
  97. *.* Use *. to find files with blank extension.
  98.  
  99.     Filenames ending in \ will have *.* appended to them so all files
  100. in the directory will be searched
  101.  
  102.     ^ in a regular expression set appearing in a position other than the
  103. leftmost will result in all the characters following the ^ being excluded
  104. from the set. [a-z^aeiou] will match the lower case consonants. ^ preceded
  105. by a backslash will be treated as a normal character.
  106.  
  107.     If the press any key prompt appearing at startup annoys you, typing
  108. mt /qd will make skipping that screen the default behavior.
  109.  
  110.     Using the /b option will give the original version of files that
  111. are changed the .BAK extension. /b+ will not alter the original file
  112. in any manner and save the altered version with the .NEW extension.
  113.  
  114.  
  115. Bugs - All the known bugs for MiniTrue 1.5 are quite minor
  116.  
  117.     When scrolling upwards, only the first line of highlights occupying
  118. multiple lines will be displayed.
  119.  
  120.     More than 32000 consecutive non-displayed, non-\n characters can
  121. result in a error
  122.  
  123.     Making replacements in text written to standard output with lines
  124. longer than 1500 characters might result in the start & ends of lines
  125. getting messed up.
  126.  
  127.  
  128. Possible features for MiniTrue 2.0
  129. MiniTrue 2.0 will be released when (and if) its released
  130.  
  131. File & Text selection
  132.     capacity to select files by date, size, other criteria
  133.     capacity to only match strings in certain line numbers, between
  134.         strings, inside a string
  135.  
  136. Textviewer
  137.     highlight previous finds/replacements instead of just current
  138.     allow entering new finds/replacements from textviewer
  139.     allow typing text directly onto screen instead of awkward sub command
  140.  
  141. Regular Expression
  142.     Support all features of extended UNIX regular expressions:
  143.         alternative    - a|b|c
  144.         recursion      - ([a-z]+\s+)+
  145.         backreferences - ([a-z])\1
  146.     Look for longest fixed string instead of first part
  147.     Capacity to insert an entire file in a replacement string
  148.     > will mean keep going until item to right of > found
  149.  
  150. Make unions boolean - allow or & not in addition to add
  151.  
  152. Allow more than 40 find/replace strings, can hopefully get up to 400
  153.  
  154. Have translate option
  155.  
  156. There are no definite plans to port MiniTrue to other platforms, but
  157. if there were, they would probably go:
  158.  
  159.   DOS protected-mode -> Linux/GNU C -> Win 32 console mode
  160.